Skip to content

Add Reddit Pixel Docs and minor update to CAPI doc #7758

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from

Conversation

akhsueh
Copy link
Contributor

@akhsueh akhsueh commented Jul 10, 2025

Proposed changes

Merge timing

ASAP when approved

@akhsueh akhsueh requested a review from a team as a code owner July 10, 2025 20:53
@akhsueh akhsueh requested a review from forstisabella July 10, 2025 20:53
@forstisabella forstisabella added the new-integration Added a new source or destination label Jul 11, 2025
@@ -60,7 +60,7 @@ Segment creates a SHA-256 hash of the following fields before sending to Reddit.

If you implement both the [Reddit Pixel](https://business.reddithelp.com/helpcenter/s/article/reddit-pixel){:target="_blank"} and [Conversions API (CAPI)](https://business.reddithelp.com/helpcenter/s/article/Conversions-API){:target="_blank"} and the same events are shared across both sources, deduplication is necessary to ensure those events aren’t double-counted.

You can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there’s less risk of incorrect integration, which can impact attribution accuracy.
The integration automatically pre-maps the Segment `messageId` as the Reddit Conversion ID. If you wish to change this, you can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there’s less risk of incorrect integration, which can impact attribution accuracy.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The integration automatically pre-maps the Segment `messageId` as the Reddit Conversion ID. If you wish to change this, you can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there’s less risk of incorrect integration, which can impact attribution accuracy.
The integration automatically pre-maps the Segment `messageId` to the Reddit Conversion ID. If you wish to change this, you can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there’s less risk of incorrect integration, which can impact attribution accuracy.

Comment on lines +2 to +3
title: Reddit Pixel
---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @joe-ayoub-segment - what's this destination's ID/status? thanks!

Suggested change
title: Reddit Pixel
---
title: Reddit Pixel
id:
---


{% include content/plan-grid.md name="actions" %}

The [Reddit Pixel](https://business.reddithelp.com/s/article/reddit-pixel){:target="_blank"} lets advertisers send Segment events to the Reddit Pixel without any additional manual JavaScript installation. This destination has Segment events pre-mapped to Reddit Pixel events and metadata. You can edit this mapping and create new events - no custom code required.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The [Reddit Pixel](https://business.reddithelp.com/s/article/reddit-pixel){:target="_blank"} lets advertisers send Segment events to the Reddit Pixel without any additional manual JavaScript installation. This destination has Segment events pre-mapped to Reddit Pixel events and metadata. You can edit this mapping and create new events - no custom code required.
The [Reddit Pixel](https://business.reddithelp.com/s/article/reddit-pixel){:target="_blank"} destination lets advertisers send Segment events to the Reddit Pixel without any additional manual JavaScript installation. This destination has Segment events pre-mapped to Reddit Pixel events and metadata. You can edit this mapping and create new events - no custom code required.

## Getting started

1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”}, find the Reddit Pixel destination and select **Add Destination**.
2. Select the source that will connect to the Reddit Pixel destination.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Select the source that will connect to the Reddit Pixel destination.
2. Select the source that you'd like to connect to the Reddit Pixel destination.


1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”}, find the Reddit Pixel destination and select **Add Destination**.
2. Select the source that will connect to the Reddit Pixel destination.
3. Open the destination settings and provide your Pixel ID. This can be found in the [Events Manager](https://ads.reddit.com/events-manager){:target="_blank"}.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Open the destination settings and provide your Pixel ID. This can be found in the [Events Manager](https://ads.reddit.com/events-manager){:target="_blank"}.
3. Open the destination settings and provide your Pixel ID. This can be found in the Reddit's [Events Manager](https://ads.reddit.com/events-manager){:target="_blank"}.

3. Open the destination settings and provide your Pixel ID. This can be found in the [Events Manager](https://ads.reddit.com/events-manager){:target="_blank"}.
4. Configure and map the events you'd like to send to the Reddit Pixel. The destination pre-maps certain Segment events to Reddit Pixel events and metadata, but you can edit these values. You can also set up custom events.

After enabling the destination, Segment will automatically initialize and load the Reddit Pixel on each page that Segment is tracking based on your mappings.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
After enabling the destination, Segment will automatically initialize and load the Reddit Pixel on each page that Segment is tracking based on your mappings.
After enabling the destination, Segment automatically initializes and loads the Reddit Pixel on each page that you'd like to track based on your mappings.

The integration automatically pre-maps the Segment `messageId` to the Reddit conversion ID. If you wish to change this, you can pass a different unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and conversion event name. This is the most accurate way to ensure proper deduplication. Reddit recommends this method since there’s less risk of incorrect integration, which can impact attribution accuracy.

To ensure your events are deduplicated:
- Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does Reddit have a recommendation for ID format? Elsewhere in the docs where users can set their own IDs Segment typically recommends UUIDv4 format to make sure folks are ending up with unique IDs

Suggested change
- Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events.
- Create a unique conversion ID for every distinct event. You can set this as a random number or ID, or the order number when tracking purchase events, for example.


To ensure your events are deduplicated:
- Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events.
- Include the event in the Reddit Pixel and CAPI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Include the event in the Reddit Pixel and CAPI.
- Include the event in both the Reddit Pixel and CAPI.

To ensure your events are deduplicated:
- Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events.
- Include the event in the Reddit Pixel and CAPI.
- Ensure the conversion event name and conversion ID for its corresponding events match.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Ensure the conversion event name and conversion ID for its corresponding events match.
- Ensure the conversion event name and conversion ID for match across the Reddit Pixel and CAPI.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration Added a new source or destination
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants